home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / scale.z / scale
Encoding:
Text File  |  2002-10-03  |  3.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ssssccccaaaalllleeee((((3333GGGG))))                                                            ssssccccaaaalllleeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ssssccccaaaalllleeee - scales and mirrors the current matrix
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ssssccccaaaalllleeee((((xxxx,,,, yyyy,,,, zzzz))))
  13.      ffffllllooooaaaatttt xxxx,,,, yyyy,,,, zzzz;;;;
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _x   expects the scale factor in the x direction.
  17.  
  18.      _y   expects the scale factor in the y direction.
  19.  
  20.      _z   expects the scale factor in the z direction.
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      ssssccccaaaalllleeee modifies the current matrix, causing it to shrink, expand, or
  24.      mirror coordinates that it transforms.  Values with a magnitude greater
  25.      than 1 result in expansion; values with a magnitude less than 1 cause
  26.      shrinkage.  Negative values result in mirrored coordinates.
  27.  
  28.      The _x, _y, and _z scale factors are used to compute a 4x4 scale matrix,
  29.      which then premultiplies the current matrix, as specified by mmmmmmmmooooddddeeee.  Thus
  30.      if _T is the current matrix, and _S is the matrix computed by ssssccccaaaalllleeee, _T is
  31.      replaced with _S*_T.
  32.  
  33.      The current matrix is the top matrix on the transformation stack if mmmmmmmmooooddddeeee
  34.      is MMMMSSSSIIIINNNNGGGGLLLLEEEE, the top matrix on the ModelView matrix stack if mmmmmmmmooooddddeeee is
  35.      MMMMVVVVIIIIEEEEWWWWIIIINNNNGGGG, the Projection matrix if mmmmmmmmooooddddeeee is MMMMPPPPRRRROOOOJJJJEEEECCCCTTTTIIIIOOOONNNN, or the Texture
  36.      matrix if mmmmmmmmooooddddeeee is MMMMTTTTEEEEXXXXTTTTUUUURRRREEEE.
  37.  
  38.      All objects drawn after ssssccccaaaalllleeee is called while mmmmmmmmooooddddeeee is either MMMMSSSSIIIINNNNGGGGLLLLEEEE or
  39.      MMMMVVVVIIIIEEEEWWWWIIIINNNNGGGG are scaled.  Use ppppuuuusssshhhhmmmmaaaattttrrrriiiixxxx and ppppooooppppmmmmaaaattttrrrriiiixxxx to preserve and
  40.      restore the unscaled coordinate system.
  41.  
  42. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  43.      mmode, popmatrix, pushmatrix, rotate, translate
  44.  
  45. NNNNOOOOTTTTEEEESSSS
  46.      Matrices that negate coordinates, such as ssssccccaaaalllleeee (-1.0, 1.0, 1.0), reverse
  47.      the directional order of a polygon's points and can cause the opposite of
  48.      what is intended.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.